home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / dev / lang / Python151.lha / Python-1.5 / README < prev    next >
Text File  |  1999-04-28  |  6KB  |  180 lines
  1.  
  2.  
  3.                                PYTHON 1.5.1
  4.                           NOTES ON THE AMIGA PORT
  5.  
  6.                               April 28, 1999.
  7.  
  8.     
  9.            Conversion and Amiga specific code by Irmen de Jong.
  10.               (Original code by Guido van Rossum and others)
  11.  
  12.  
  13.  
  14.                    Read the file <DISCL_and_COPYRIGHT>!
  15.  
  16.    It contains the disclaimer for this software, and copyright notices.
  17.  
  18.  
  19.  
  20.     Contents:
  21.     ~~~~~~~~~
  22.  
  23.     1. What's new?    
  24.     2. General remarks.
  25.     3. Troubleshooting.
  26.     4. Thanks.
  27.  
  28.  
  29. +----------------------+
  30. |                      |
  31. |  1. What's new?      |
  32. |                      |
  33. +----------------------+
  34.  
  35. IMPORTANT CHANGES SINCE THE PREVIOUS VERSION (version 1.5.1 June 6 1998):
  36.  
  37.     - Updated time.strftime() function. Should pass the test now.
  38.     - Separate I-Net 225 version available (beta). Grab it from my website.
  39.     - Added configuration options to the ARexx.py and arexxll modules:
  40.       setstringmsgs and settokenizeline.
  41.  
  42. THIS IS LIKELY THE VERY LAST 1.5.1 VERSION THAT WILL BE AVAILABLE.
  43. WE SHOULD ALL SWITCH TO 1.5.2 IN DUE COURSE... :-)
  44.  
  45.  
  46. +----------------------+
  47. |                      |
  48. |  2. General remarks  |
  49. |                      |
  50. +----------------------+
  51.  
  52. * The MAIN PYTHON SITE is <http://www.python.org>. All general documentation
  53.   can be obtained from here (Python tutorial, language reference, library
  54.   reference and much more).
  55.  
  56. * The above mentioned documentation is also available on Aminet, as
  57.   dev/lang/Python_Doc.lha.
  58.  
  59. * The AmigaPython homepage is at http://www.bigfoot.com/~irmen/python.html
  60.   (note the new address!). Check it out for news, future plans, bugs etc.
  61.   You can also obtain the beta I-Net 225 version here.
  62.  
  63. * In the `Docs/Amiga' directory you can find the docs for the Amiga specific
  64.   modules and features. Read them, they contain vital information!
  65.  
  66. * The Python library contains an extensive test set.
  67.   To try it yourself, type (after installation):
  68.     Python -c "import test.autotest" (and have patience...)
  69.     Python -c "import test.autotest" (and have patience...)
  70.   (Yes: do it TWICE because the generated .pyc files need to be checked too).
  71.   (You can also start the RunTest.py script from the Workbench).
  72.   Some tests cannot run on the Amiga - they will be skipped.
  73.   The report at the end should say something like:
  74.     31 tests OK.
  75.     1 test failed: test_strftime    (this is OK; strftime is wrong)
  76.     18 tests skipped:  .....
  77.   If you don't start AmiTCP first, test_socket and test_select will fail.
  78.   If usergroup.library cannot be opened, crypt, grp and pwd will fail.
  79.  
  80. * To  see  some  command  line  options,  use  the -?  option, or any other
  81.   unrecognised option.
  82.  
  83. * To run a speed benchmark, type:
  84.     Python -c "import test.pystone; test.pystone.main()"
  85.   and have some patience. On my system, I get 360 pystones/second.
  86.  
  87. * In the `Icons' directory there are some icon suggestions.
  88.   def_py.info is an icon for Python source files (.py)
  89.   def_pyc.info is an icon for Pytnon bytecode files (.pyc)
  90.  
  91. * The following modules are built-in in this release:
  92.     ARexxll    Doslib    amiga    array       binascii    cPickle
  93.     cStringIO  cmath     crypt    environment errno       grp
  94.     imp        marshal   math     md5         new         operator
  95.     pcre       pwd       regex    rotor       select      socket
  96.     soundex    strop     struct   sys         syslog      time
  97.     timing
  98.  
  99.   Amiga specific: amiga, ARexxll, Doslib, environment
  100.   Needs usergroup.library: crypt, grp, pwd.
  101.   Needs AmiTCP's bsdsocket.library: select, socket, syslog.
  102.  
  103. * Mail  me  if  you encounter any Amiga specific problems, or if you have any
  104.   Amiga  related  questions  about  Python,  or  just  for fun.  General
  105.   questions are better asked on the usenet newsgroup comp.lang.python.  A lot
  106.   of   information,   including  an  online  manual,  can  be  obtained  from
  107.   <http://www.python.org/>. Read the FAQ before asking!
  108.  
  109.  
  110. +-----------------------+
  111. |                       |
  112. |  3. Troubleshooting   |
  113. |                       |
  114. +-----------------------+
  115.  
  116. * When  I  try  to  install  Python,  I  get  "Unable  to  open  your tool
  117.   'installer'"!
  118.  
  119.   The Installer® utility is required for installation, but it is not included
  120.   in  the  archive.   Get  it  from  somewhere  else  and  copy it to your C:
  121.   directory or somewhere where Workbench can find it.
  122.  
  123. * When I start python, I get "This program requires a math co-processor"!
  124.  
  125.   You should upgrade your computer to at least a 68030 with a FPU.
  126.  
  127. * I   get   "Couldn't   open   bsdsocket.library"   or   "Couldn't   open
  128.   usergroup.library" errors!
  129.  
  130.   You  are  trying to use functions that need one of these libraries.  AmiTCP
  131.   is required if you want to use all (network) functions.
  132.  
  133. * Python crashes when executing complex (recursive) code!
  134.  
  135.   This should not happen; you should get a MemoryError exception.  If it does
  136.   crash, increase your stack size and try again.  Python's default stack size
  137.   is 20K, which should be enough for most programs.
  138.  
  139. * Functions which use the PIPE: device (like os.popen) seem to work
  140.   incorrectly!
  141.  
  142.   The default l:queue-handler is buggy.  Make sure you have installed a fixed
  143.   l:queue-handler (I'm using util/sys/HWGQueue.lha from Aminet)
  144.  
  145. * I cannot import Dos or ARexx!
  146.  
  147.   Try `import site' first.
  148.  
  149. * Other errors
  150.  
  151.   Mail me at irmen@bigfoot.com with a clear description of the problem.
  152.  
  153.  
  154. +-----------------------+
  155. |                       |
  156. |  4. Thanks            |
  157. |                       |
  158. +-----------------------+
  159.  
  160. Ofcourse this product could never have happened without the support of various
  161. people. Amongst others I'd like to thank:
  162.  
  163. Guido van Rossum - for creating Python in the first place
  164. Mike Meyer for his various suggestions and problem reports
  165. Kent Polk for his various suggestions and problem reports
  166. Lyster E. Wick for his various contributions (NewIcons/ARexx/WB/bugreports)
  167.  
  168. and my friends who supported me in the first phase of this project (that
  169. was LONG ago, in the Python 1.2 days).
  170.  
  171. If you think your name is missing here, drop me a line.
  172.  
  173. Every AmigaPython user out there, thanks for your interest!
  174.  
  175.  
  176.  
  177.  
  178.                     Irmen de Jong
  179.                     (irmen@bigfoot.com)
  180.